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Abstract: 


BSYS is a subsystem for the TOPS20 and TENEX timesharing systemse It 
provides facilities for dumpinge restorina and archivine user filese 
It is also a file system utility allowing a wide variety of functions 
for verifyings examining and fixing file system problems. In 
philosoohy it is intended as an extension of the TOPS20 file system to 
magnetic tape storages allowinc file name recosnitions directories 
etc» The descristions will be relative to a TOPS-20 system. 
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INTRODUCTION 
The backup system (BSYS) has three main purposes: 


Protection for both the user and the system against catastrophic loss 
of data (filesd.e 


Rutomatic (or manual if desired) file saving and deletion of inactive 
(not referenced ) filese In this manners it also provides for another 
Level of file storage. 

A general file system utility for verifying user directoriess 
deleting extra versionse and a wide variety of useful operations on the 
file systeme 

CONVENTIONS 


In writina this documents the following conventions are used? 


1} Instructions about things to do are enclosed in parenthesese 
Ex: (mount dectape on unit 0) 


2} When describing interactions with the system, characters typec 
sy the user are captitalizedsand characters typed by the system 


are lLowercasee 


3) Special control characters will be described with the following 
notations: 
@} <ALT> is an Altmode or Escape 
b> <CR> is a Carriage Return 
cd <SP> is a Space 
cd} <*D> is a Controt D 
e€} <*C> 35 a Control Cs etce 


43 In How-to-do-it scenarios semicolon is used to delineate 
comments as in the EXEC comment convention and FPOP10 Macro 


5) # - is used to signify the operator is to enter a number 
63 NUL: =- is used on TOPS=-20 System 

7) NILS - is used on TENEX System 

8} « ~ is used before the generation number on TOPS-20 System 
93 3 - is used before the version number on TENEX Systen 


10)4 carriage return <CR>in response to a "lListina to" questiion 
defaults to TTYé 
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DUMPS 
General Cescription 


BSYS dumps provide an additional level of file storage to the 
TOPS2S timesharing systeme They fundamentally do a "nace" copy of a 
file group to magnetic tape storagee BSYS dumps differ from 
Qutoer in that the tapes produced by BSYS have directories and 
as such "know" where a file is on the tape and can position directly 
to the desired file (forward or backward). The directory also allows 
the Listing of a specific tapes contentse 

Information about the Last dump tape number plus the time and date 
of the Last dump is maintained in the FDB of eech file in the 
file systeme This data is only updated for Full and Full Incremental 
dumpse This allows you to do as many directory dumps as you Like 
without affecting any systematic dumping/retrieving process being 
done by you ‘local operations staffe This information should aid in 
recovering smashed of otherwise destroyed files from dump tapese 


*x* SPECIAL NOTE ak 

You must Let BSYS unload a tape or return to prompt the 
operator with "x" or a question before you can deselect that 
unite If you do not the tape will be no good!! BSYS "rewrites" 
the directory on the front of each tapee The common Mini-dumper 
practice of deselecting the tape unit at rewind time is 
disastrous when using BSYSe Bue to a completion marking 
mechanism the files would be redumped on a sSudsequent Gump 
Cincremental) but the dumped data and time used is Loste 
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Dumoaing the entire file system 
what a Full Dump does 


The Full Dump function of BSYS copies the entire file system 
onto nagnetic tapese This process takes abcut 1/72 hour per tapee 
An 800 BrI tape contains approximately 5209 nages and a 1600 BPI 
doubles that amounte 


How to do a Full Dumo 


le Mount blank tapes on tape units and be sure they have 
write rings in them!!! 
2e Login as a user with OPERATORCHHEEL) capabilities. 
aenable 
'eBSYS<CRD 
(site name)-(system)-—bsys version date 
type cntrl-d to abort type iny cntrl-p cntrl-c to abort run 
*FKALT>DuLL dump Centire file system)<CR> 
enter tape unit mta # 
s; # - type proper unit number 
Listing to file <cr>-for neys Csite*s choice )<CR> 
3 ie: LPTis TTY: ee . 
tape mumber R<CR> 
; # - type tape number on tape reet 
+ The dump should now be runninGeecee 
s; when BSYS has filled up the first tapes it rewinds 
> that tapee writes the tape directory at the front of 
s; the tape and instructs 
> the operator to: 


enter tape unit mta # 
> # - next unit number 
tape number #<CR> 
ss # - the tape number of next tape 
when the dump is completed (last tape rewinds)e 
You must wait for the "«", 


ws we 
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Dumotna a User Directory(s) 
What OSJump Directory does 


The Birectory DOump function of SSYS copies an entire user 
directory onto magnetic tapese The length of time required to do 
this operation is a function of the system toad and the total 
number of pages in the specific user directorye At the end of 
dumping each directory the operator is given the opportunity to 
specify another directorye 


How to do a Dump Directory 


le Mount plank tanes on tape units and be sure they have 
write rings itn them!!! 
2-6 Login as a user with OPERATORCWHEEL) capabilitiese 
aEnable 
FBSYS<CR>D : 
(site named-(system)-bsys version date 
type cntrti-d to abort type ine cntrl-p cntrl-c to abort run 
*DUCALT>mp directory<CR> 


Privileged user? Yes<CR> 
sa non privileged user can only dump 
shis own directorye | 
Directory: FOOBAR<CR> 
List of files? No<CR> 
sYES permits a List of files to be selected 
sterminated by a blank Linee 
enter tape unit mta # 
; # - type proper unit number 
Listing to file <cr> for tty: <CR> 
s te: LPTi¢e TTY: ee 
tape number #<CRD> 
> & - type tape number on tepe reel 
enter tape id: TEXTe«ee<CR> 
3; like "Dump Of <FOOBAR>" 
The dump should now be runninGeee 
When 8BSYS has filled up the first taper it rewinds 
that tapes writes the tape directory at the front of 
the tapes and if it needs another tape instructs the 
operator to: 


wee wt St we VO 


enter tape unit mta # 


s;# - the proper unit number 
tape number #<CR> 
3# - the tape number of next tape 


When the dumo is completed (last tape rewinds),s, 
You must wait for the "«", 


ae we 
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Incremental Cumos 
what an Incremental Dump does 


The Incremental Dump function of 8SYS conies all files that 
have been written since either the last dump or since a specified 
date and time onto magnetic tapese 


How to do an Incremental Dump of the entire fite system 


le Mount olank tapes on tape units and be sure they have 

write rings in them!!! . 
26 Login as a user with OPERATOR(WHEEL) capabilitie2se 
@Enable 

IBSYS<CR> 

(site name)-(system)-bsys version date 

tyne cntrl-d to abort type ine cntrl—-p cntrl—-c to abort run 

*INC<ALT>remental dump (changed files)<CR> 


dump since date and timely or n)? Yes<CR> 
enter date and time: MO/DA/YR HH:SMM<CCR> 
or any valid IDTIM format 
If NO is specified then BSYS dumps all 
files changed since the last dumpe 
entire file system? Yes<CR> 
enter tape unit mta # 
+ #F - type proper unit number 
Listing to file <cr> for tty: (sitite*s choice }<CR> 
s 1e3 LPT2e TTY? ee 
tape number H#<CR> 
s # - type tape number on tape reel 
The dump should now be runningeee 
When 8SYS has filled up the first taper it rewinds 
that tapes writes the tape directory at the front of 
the tapes and if it needs another tape instructs the 
operator to: 


we 


we we 


ee we Pe BO Be 


enter tape unit mta # 


3 # - next unit number 
tape number #<CR> 
3; # - the tape numbder of next tape 


When the dump is completed (last tape rewinds)s 


3 
s You must wait for the "*". 
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tiow to do an Incremental Dump of a specific directory{s) 


le Mount blank tapes on tape units and be sure they have 
write rinas in them!!! 

2e Login as a user with OPERATORCWHEEL) capabilitiese 

aEnabdle 


PeSYS<CRS 
(site named-Csystem)~-bsys version cate 

type centrti-d to abort type ine ecntrk—-p cntrl-c to abort 
*INC<ALT>remental dump (changed files)<CR> 


dumo since date and timeCy or nd? Yes<CR> 
enter date and time: MO/DA/YR HH:SMM<CCR> 
s or any valid IDTI@M format 
If NO is specified then ESYS dumps all 
files changed since the Last dumpe 
entire file system? No<CR> 
Privileged user? Yes<CR> 
directory; FOOBAR<KCR> 
List of files? Yes<CR> 
type file Lists terminated with null Line: 
enter tape unit mata # 
> # - type proper unit number 
Listing to file <cr> for tty: <CR> 
s tes LPTse TTY? ee 
new tape? Yes ECconfirmI<CR> 


we we wv 


3; answering the preceding question NG allows you to 
s; “append"® files to the end of an existing BSYS tape 
s the following question will not be 
+ asked in the NO casee 

tape number #<CRD 


> # - type tape number on tape reel 
The dump should now be runningeee 
When BSYS has filled up the first tapes it rewinds 
that tapes writes the tape directory at the front of 


the tapes and if it needs another tape instructs the 
operator to? 


wee PE O09 Oe we 


enter tape unit mta # 


s # - next unit number 
tape number #<CR> 
s # - the tape number of next tape 


when the files for the given directory have been 
dumpeds you may select othersee 
ore users? No<CR> 
s When the dump ts completed (last tape rewinds), 
>; You must wait for the "x", 


SJ owe we 


run 


Continui 


What 
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mg Dumps 
Continue Dump does 


The continue dunp function will restart full and incrementa 
dumps (entire file system) that were interrupted. 


BSYS keeps track of the Last completed dump tape #¢ present 


di 


rectory numders the original connected directory number and 


dumo id-text,s allowing the operator to get the dump 
going again by suppling a minimum of datae 


BSYS deletes the continue data upon succesfull completion o 


dumpe If you attempt to continue a dump that was not interrup 


ad 


normally¢ BSYS will place you in "manual"® modee This means 
BSYS will ask you for all the data it requires to restart a 


dump at a given usere 


How t 


1e 


Qe 


o Continue a Dump 


Mount bLank tapes on tape units and be sure they have 
write rings in them!!! Be careful not to use any previousl 
completed dump tapese 

Login as a user with OPERATOR(WHEEL) capabilities. 

aEnable | 

'BSYS<CR>D 

(site name)-(system)-bsys version date 


L 


f a 
ted 
that 


¥ 


type cntrl-d to abort type ins cntrl-p cntri-c to abort run 


*CONT<ALT>inue dump<CR> 
> at this point you may get the message 
; "No continue record?? entering manual mode" 
>; if this happens go to "manual mode" below 
enter tape unit mta # 
> # - type proper unit number 
Listing to file <cr> for tty: (site®s choice d<cCR> 
> tes LPTSe TTY: oo 
tape number #<CR> 
s # - type tape number on tape reel 
Gump restarted at user name 


s the dump should now be runninGeee 
s When 8BSYS has filled up the first tapes it rewinds 
s that tape and writes the tape directory at the front of 
3 the tapes and if it needs another tape instructs the 
s operator to: 


enter tape unit mta # 
+ # - next unit number 
tape number #<CR> 
> # - the tape number of next tape 
When the dump is completed (last tape rewinds)s 
You must watt for the "x", 


wae me 
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4. Manual mode 

; this is caused by one of two things 
; 1) you are not really continuing a cump 
$s 2) BSYS screwed up in writing the continue date and you 
must now supply ite This is analogous to a normal dump 
(full or incremental) except you have the option of which 


directory to start dumpinge 
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LOAD/RESTORE 


General description 


LOAD AND RESTORE are the commands used to copy files from magnetic 
tape stcrage to the active file systeme LOAD is used if the desired 
resultant file is to be a new filee That is it should retain none of 
its original attributes except the dataeCie: creation datesarchive 
statuss etcee) RESTORE is used if the file is to reappear in the 
file system exactly as it was when it was dumped or archivede 


Load files (from magtape} 
What load does 


The Load command allows copying a file group 

from magnetic tape to the active file systeme 
'BSYS<CRD . 

(site name)-Csystem)—-bDsys version date 

type cntrl-d to abort type ine cntrl-p to abort run 
*LOAD files (Cfrom magtape) 

enter tape mta # 

Listing to file <cr> for tty: <CR> 

mounting tape directory 

copy mtal: <TAPE-DIR>*eSAV3* <ALT> to <DSK-DIR>D CALTSD 
sThis will cause the save files to be loaded into the 
sdirectory on diske 

more files (this tape)? No<CR> 

move tapes? No<CR> 

* 


Loading a single file 


IBSYS<CRD 

(site name)d-(Csystem)-bsys version date 
type cntrti-d to abort type ine cntrl-p cntrl-c to abort run 
*LO<ALT>ad files (from magtape)<CR> 


enter tape unit mta # 
; "#" Fs the number of the tape unit 
Listing to file <cr> for tty: <CR> 
3 ie: LPTS¢e TTY: ee 
mounting tape directory 
copy mta#: <DIRECTORYSOFILENAME eEXTSVERCCR> 
s; Altmode and citrl-f can be used to recognize both 
> the tape file*s directory name and file name. 
(tod <DIRECTORYDFILENAMECEXTSVER<CRD> 
copy mtan:s <*D> 
*ECALTDKXIt<CCRD 
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Restore files (from magtane) 
What restore does 


Restore brings back one file(group) from a BSYS-dumped tapes 
and writes it on the disk with the exact characteristics of that 
file when it was originally on-Linee ices the directorys names 
extension, version numbers datessy and archive parameters are 
exactly the same. 


How-to procedures 
1)? Restoring a single file 


@eEnable 

IBSYS<CR> 
(site name)d-(€system)-bsys version date 

type cntrti-d to abort type ins cntrl-p cntrl-c to abort run 
*RES<KALT>tore files (from tape)<CR> 


enter tape unit mta # 

> "#" is the number of the tape unit 
Listing to file <cr> for tty: <CR> 

> jie: LPTs TTY: ec 

mounting tape directory 

restore mta#: <DIRECTORYDFILEeEXTs VER<CR> 
Altmode and ctrl-f can be used to recognize both 
the tape file*s directory name and file name but not 
the extensione | 
restcre mtat: <7D> 
*ECALT>xIt<CR>D 


we we we 


2) Restorina a single directory 


a@Enable 
'BSYSKALTD<CCRD 
{site name)d-Csystem)—-bsys version date 


type cntrl-d to abort type ins cntrl-p cntrt—-c to abort run 
*RES<ALT>tore files (from tape)<CR> 


enter tape unit mta # 
; "#" ds the number of the tape unit 
Listing to file <cr> for tty: <CR> 
> tes LPTSe TTY: ee 
mounting tape directory 
restore mta#: <DIRECTORY>*.*3*<€CRD> 
restore mta#: <*D> . 
3; <*D> - aborts further restore and gets back to BSYS 
scommand Level 
*ECALT>DxIt<CR> 
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Restoring the entire file system 
Description 


The RESTORE command provides for restoring the entire file 
systene The file system may be restored either from a full dump 
set of tapes or from a combination of incremental tapes and a 
full dump sete In the Later case the facility to prevent ghosts 
(files deleted) is providede The only requirement is that the 
first tape of the the most recent dump Ceither full or 
incremental) be loaded firste This allows BSYS to obtain the most 
recent copy of the file <SYSTEM>DIRECTORY31 (for a TENEX system) 
to check files prior to restoration as to whether they where 
in the "Last" state of the file systeme For TOPS-20 systems, 
BSYS determines "Last" state from the directory files in 
<ROOT-DIRECTORYD>D- 

How-to scenario 


aEnable 
'BSYS<KALTO<CRD 
(site named-(system)—-bsys version date 
type cntrl-d to abort type ine cntrl-p cntrt-c to abort run 
*RES<KALTStore files (from tape)<CR> 


enter tape unit mta # 
; "#" dis the number of the tape unit 
Listing to file <cer> for tty: NIL:<CR> 
3 jes LPTos TTY> ee 
mounting tape directory 
restore mta#ti <*>*ex5*<CCR> 
create users? Yes Cconfirmi<CR> 
3; Users may be created from the first tape of an 
> incremental or full dump. 
3 If No is specified BSYS assumes that users already 
3 exists and bypasses creating them 
Go you wish to sypass restore checks ? No<CR> 
+ The file <system>directoryes1l is taken from the tape and used 
s to check the files as they are restorece 
more tapes ? Yes<CR> 
+ The tapes of the next older set of dumps should be 
+ processed back to the Last full dump. 


BSY 


S 
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Retrieving a File 


How-to scenario 


Descriotion 


The retrieve function allows automatic restoring of files 
from tapese When the user makes a retrieval request; it is 
entered into <SYSTEMDRETRIEVE-REQUESTSeRINARYe The retrieve 
function periodically examines the contents of this file to 
see if there are any requests to processe If so it 
asks the ooerator to mount the primary tape and 
the file is automatically restored. If primary is not available 
or the file not found (should never happen) 83SYS witk itnforns 
requestor (file not on first tape--will try second). The next 
retrieve scans the request List it will ask for secondary tape 
and tne file is automatically restorede The user is then sent a 
message describing the status of the requeste 


aEnable 
IBSYS<ALTOSCCRD 
(site named-(system)-bsys version date 
type cntril-d to abort type ins cntrl-p cntri-c to abort run 
*RETCALTOrieve Carchived files) 


Listing to file <cr> for tty: <CR> 
¢ tec LPTie TTY: ex 
Continuous for all users ? No<CR> 
s if yese the next 3 questions are not asked 
Modify request list before processing? No <CR> 
+s if yese the requests are listed and the subcommands 
+ Of deletes continues mark as dones errors 
+; liste and reset are available. 
Continuous Check for Retrieval Requests? Yes <CR> 
Process Retrival Requests for all Users? Yes<CR> 
> if nos 
users: USER-DIRCCRD 
Process Retrieval Requests for Local users only? Yes<CR> 
s either the List of tapes witl be Listed or the proaram 
+s Will give the messace "No retrieval requests to process" 
get tapes: He He Heeee 
please mount (site) primary tape # ok? Yes CconfirmIJ<CR> 
enter tape unit mta # 
mounting tape directory 
the date and header info of the tape is. listed 
then the file and who requested it are listed 
-isial] <msg-group> msgfixesav3l by user usr-name 
a message is sent to the user that the file has been retrieved 
untess the user is exempt from the messaGe-s 
o exit from Retrieving you must type CNTRL-C 
f it was tn continuous mode. 


T ee we 


wt we Vt we 


ade Oe 


Description 
Tape copy allows the operator to copy a 5SYS tape 
and rebuild the directory on the front of the 


2 Ss £ ) = Aa nae. aoe! Ge ee oe ae et ee Ee | 


BS oa 
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How-to orocedures 


le 


Se 


Mount the tape to be copied and a blank tape on tape units and 
be sure there is a write ring in the tape to de copied tot !! Be 
careful not to use a tape with files recorded on ite 
Tape copy of a tape which has a bad begining of tase 
adEnable 
'BSYSCCRD 

(site name)-Csystem)-bsys version cate 
type cntrtl-d to abort type ins cntrl—-p entri-c to abort run 
x*TACALT>pe copy <CR> 


Listing to file <cr> for tty: <CR> 
enter "from" tape mta # 
enter "to" tape mta # 
do you want to rewind "from" tape ? No<CR> 
Read header from "from" tape ? No<CR> 
Reconstruct tape header ? Yes<CR> 
(site name) tape number #<CR> 
3; # - number to be put on tape 
Enter tape id: TEXTeee<CRD> 
> Otherwise the header id is copied from the "from" tapee 
Copyitna: 
: the header is Listed with the tape number > 
s When the copy is completed both tapes are unloaded 
s you must wait for the "*", 


Copy of tape that has a good tape header 
ainable 
'BSYSCKERD 
(site named-Csystem)-bsys version date 


type cntrl-d to abort type ing cntrl-p cntril-c to abort run 
*TASALTSpe copy <cRk> 


Listing to file <cr> for tty: <CR> 

enter "from" tave mta # 

enter "to" tape mta # 

cdo you want to rewind "from" tape ? No<C&> 
Read header from "from" tape ? Yes<CR> 
Reconstruct tape header ? No<CR> 

Copying: 

> you must wait for the "*". 
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Loading a Single file 
What single does 


Single also allows you to retrieve a file from. a 8SYS-dumped 
tapee howevers it differs from restores in that you can specify 
new file descriptorse rather than simply accept the old onese 


How-to load a single file 


(site name)-(system)-bsys version date 
type cntrl-ad to abort type ing cntrl-p cntrtl-ce to abort run 
*SICALTOngle files<CR> 


enter tape unit mta # 

s; # —- tape unit number 

mounting tape directory 
copy mta#:<DIRECTORYSFILENAMEeCEXTSVERCKCRD> 
(to) <CDIRECTFORYSFILENAMEeEXT$sVER<KCR> 

copy mta#: (7D) 

s (€*d) is the BSYS abort character 
*ECALTOxIt<CR> 
Treset<CR> 
"tape-file-name" must include the directory namey as wetl as the 
other file descriatorse Altmode can be used to recognize both 
the tape file*s directory name and file howevers if you use an 
altmode for recognition of the file names you do not need to type 
the confirming cre alsos if you use an altmode for the 
disk-file-namese you only need 1 (Cone) confirming cre} 
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ARCHIVE SYSTEM 


The archive system uses a special form of the BSYS dump facility 
to process the file system and dump user files to magnetic tapee 
Facilities are provided for: 


Soecific Archive Requests 
Automatic File Deletion Cafter archival) 
Automatic Archival of Files not referenced in "n" days 
Automatic Notification of an operator for manual retrieval 
Inquiry for specific file archive information 

Exempt the directory from archive 

Archive all but the higest version of files 


. 


How-to scenarios 
13 Generating a list of archivable files: 


atnable 
'BSYSCCR> 
(site name)d-(system)-bsys version date 
type ecntrkl-d to abort type ine cntrl-p cntri-e to abort run 
x*ARCHCALT> ive Cuser files) <CR> 


archival period (days) = #<CR> 
Listing only? Yes CConfirmiJ<CR> 
Listing to file <cr>d for tty: <CR> 
pass-2 ? ¢y/ndNo<CR> 
entire file system? Yes ECconfirmi<CR> 
List for users? No ECconfirmJ<CR> 


2) De eee a List of files to be archived to users: 
xxx Not sure of this «*** 


note: setup files <ARCHIVE>ARCHIVE-MESSAGEe TXT and 
KARCHIVEDAR CHIVE-FILES-ONLYeTXT 
@Enaole 
'BSYSCCRD 

(site name)-C(system)-bsys version date 
type cntrtl-d to abort type ins cntrl-p cntrt-c to abort run 
*ARCHCALT>Dive Cuser files) <CR> 


archival oeriod (days) = # CConfirmi1<CR> 
Listing onty? Yes CconfirmiI<CR> 
entire file system? Yes Cconfirmi<CR> 


List for users? Yes Cconfirm1<CR> 
kkk kkx 
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3) Archiving user files: 
@Enable 
IBSYS<CRD 
(site name)-(system)-bsys verston date 


type cntrl-d to adort type ins cntrl-p cntri-c to abort run 
*ARCHCALTDive Cuser files) <CR> 


archival period (days) = #<CR> 
Listing only? No CconfirmJ<CR> 
Listing to file <er> for tty: LPT: 
$ tet LPTSs» TTY: es 
pass~-2 ? Cy/nINo<CR> 
; To tnsure that there is no mix of pass-1 and pass-2 
s files on the same tapee 
entire file system? Yes CconfirmJ<CR> 
List for users ? No-Cconfirm1J<CR> 
enter tape unit mta #4 new tape ? Yes Cconfirmi1<CR> 
really? Yes<CR> 
(site) tape # number #<CR> 
Cif new tape = no then BSYS says) 
mounting tape directory 
BSYS now types a List of users and data about file archival 


6 
4) Interrogating the magtape archive: 


The EXEC and BSYS command INTERROGATE calls the Csystem>archive-Looku 

prosram to search the archive-directory filee 

@INT<ALT>errogate <DIRNAMEDFILE ee XTSVERHCCRD>D 
ALL TOPS20 filename conventions apply 
CKO Se*FeALTMODE*oETCe de If any groups are specified (*} 
then you will get a List of archived file belonging to that 
groupe Only single file retrieval reguests are permitted! 
If the file is found in the archive then the user is askede 

file is archived on tapes xxx and yyy 

do you want it retrieved Cy or n) ? YesLconfirm] <CR> 

xxx filename recognition «*x 


syour request has been noted you will be notified when 
scompleted 
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file system UTILITIES 
General Description 


BSYS*s ability to "run" the file system structure (tape directory 
toc!) allows the implementation of virtually any utility function 
desireéde : 


ARCMES CCLEAR TAPE NUMBER FROM BACKUP WORDS) 
nat arcemes does 


ARCYMES Looks at every fdb in the file system to see if 
the specified tape number is in either the Left or right half 
of the archive tape backup worde If it finds the tape number 
in either halfe it clears that half of the worde It also clears 
the "deleted" bit in fdbctl to make sure the files isn*t expunged 
before it has a chance to be rearchivede This is useful if 
BSYS or the system crashes when BSYS is "marking" the fdo*s 
after the file has been dumped to tapee 
There is a further check not to delete the number if the file 
was archived 24 hours or more from the present timee 


How to run arcmes 


a@Enable 

TBSYS<CRD 

(site name)~-(system)-bsys version date 

type cntrl-d to abort type ine cntrl-p cntri-c to adort run 
*ARCMESCCRD> 

Tape number to purge from backup words: #<CR8> 

> # - number of tape to purge 

Number of hours to go back for purge: #<CR> 

s # - files archived before that time witk not be purged of 
; the tape number. 

+ Wait until the "*" BSYS promot is typed 

*¥EXIT<CRD 


3 exit 3SYS 
COUNT (directory file pages) 
What count does 


Count processes a single directory or the entire file system 
and adds up the number of disk pages in use and produces a report 
of counts by usere As an option it will update the working count 
in the directory overhead block(TENEX only)de This option is 
particularly useful when enforcing the dise allocation option in 
TENEX versions 130 or lLatere 
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How to run count 
counting a single directory 


aEnable 

'BSYS<CR> 
(site name)-C€system)-bsys version date 

type cntrl-d to abort type ins cntrl—-p cntrl-c to abort run 
*COUCALTOnNt (file pages)<CR> 


Listing only? Yes 
sif NO is specified then as a byproduct of the 
scount Listing the working count (in the 
sdirectory overhead block) is updated. 

entire file system? No 

directory: DIRECTORY-NAMECCR> 
+ BSYS now types (on the controlling tty) 


directory-name : # files # pages (#) disc max= # 
*ECALTOXIT<CRD 

+s the number following the word "pages" is The working 

3 count and only appears if its different than the 

+s actual counte 


counting the entire file system 


Enable 

'BSYS<CR> 

(site named-(€system)-bsys version date 

type entri-d to abort type ins entrl-p cntrt-c to abort run 
*COUCALTOnNt (file pages)<CR> 


Listing only? Yes<CR> 
sif NO is specified then as a byproduct of the 
scount Listing the working count Cin the 
sdirectory overhead block) is updatede 

entire file system? Yes<CR> 

Listing to file <cr> for tty: <CR> 

+ 1@2-LPTi¢s TTY: ec 
*ECALT>x it <CR> 
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QISMOUNT (magtape directory) 


This 8S8YS function is intended for fixing maatape directories and 
should not be used except by knowledgeable systems people. 


LIST (magtaoe directory) 
What List does 


The Listing function produces a directory Listing for any EBSYS 
dump tape@e 

It also provides a feature to List the mapping cf the file 

specified Like the index or directory file that can 

be used to patch the file system instead of a complete re-load. 


How to do a list 


aeEnable 
IBSYS<CCRD 
(site name)-(system)—bsys version date 
type cntrl-d to abort type ins cntrl-p cntrl-c to abort run 
*LICALT>st (magtape directory)<CR> 


enter tape unit mta # Listing to file ¢cr> for tty:<CR> 

s"#" ds the number of the tape unit 

> te:3 LPTt¢ TTY: ee 

List tase mapping for files? No<CR> 

entire tape? Yes<CR> 

sif No 

tape directory: DIRECTORY-NAME<CR> 

sif the mapping was requested the pages of the file 

sare Listed alona with the page protection word 

s3set when the file was dumped giving the protection 

sand disk page indexe | 
*ECALT>xit<CR>d 


MCUNT (magtape directory) 


This BSYS function is intended for fixing mastape directories and 
should not be used except by knowledgeable systems people. 


OCTAL PRINT Cof directory) 
what octal print does 


OCTAL produces a formated dump of either a system directory or 
a magtape directorye The dump produced is ala DDT and is quite 
useful in repairing smashed directories or simply verifying 
something about a directorye Try it you*ll like it. 

There is also an option to select the INDEX fite for TENEX and 

select subindex Oesleece This can also be very usefule 


How to do an octal print 


aenable 
'BSYS<CR>D 
(site name)-Csystem)—-bsys version date 
type cntrl-d to abort type ins cntrl-p cntrt—-c to abort run 
*O<ALTOctal print (of directory)<CR> 


tape? Yes 
+; if no is specified the tape request is omitted 
enter tape unit mta # 
use index file? No<CR> 
directory: DBIRECTORY-NAMECCR> 
Listing to file <cr> for tty: LPT: <CR> 
another? Yes<¢CR> 
use index file? Yes<CR> 
subinaex number: #<CRD> 
Listing to file <cr> for tty: LPT: <CR> 
another? No<CR> 
* 
*ECALT>Dxit<cR> 
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SAVE Carchive directories on tape) 


What Save does 
Save dumps every archive directory to a tape to insure 
that users an/or the system dontt clobber the user'fs 
archive information 


How to do a save 
aEnable 
Thsys<CR> 
(site name)-(Csystem)-bsys version cate 
type cntrl-d to abort type ine centrl-p cntrb-c to abort run 
*SACALT>ve CARCHIVE DIRECTORIES ON TAPE)<CRD> 


entire file system ? No<CR> 
directory: DIR-NAME<CR> 
enter tape unit mta # 
> # - type proper unit number 
Listing to file <cr> for tty: <CR> 
+ Tet LPTs TTY: ee 
new tape? No CconfirmJ<CR> 
sif yes then the following request 
tape number #<CR> 
> # - type tape number on tape reel 
more users? No<CR> 
*EXITCCR> 


TRIM (user directories) for TENEX systems only 
what Trin does 


Trim will process a directory (or alt the directories in the 
file system) and delete all but the specified number of versions 
of each file in that directorye If "n" is greater than one ESYS 
retains the n-1 most recent versions and the oldest. Howevere 
Trim does not expunge these filese That is done in a separate 
operatione 


How to do atrin 


atnaole 
tBSYSCCRD 
(site named-(systemd-bsys version date 
type cntrl-d to abort type ins cntrl-p cntrt-c to abort run 
*TRCALT>SIinm Cuser directories) <CR> 


enter number of versions to retain: #<CR> 
really? Yes<CR> 
entire file system? No<CR> 
directory: DIRECTORY-NAMECCR> 
trin completed 
* 
KE CALTDxAIt<CRD 
TRESETCCRD 
(In the avovey "n" is the number of versions to be left 
undeleted.s. Usually this number is 1 (one).e) 


BSYS - TOPS26 Sackup SYSten Page 22 
OPERATORS MANUAL 


VERIFY Cuser airectories? 
what Verify does 


Verify checks all the pointers in the FDS (File Description 
SlLock) for every file in the directory. If these pointers are 
not corrects BSYS cannot correct the probleme but will print an 
error concerning ite The conditions checked by BSYS are 
different from those checked by CHECKDSK. 


1} How to do an full system verify 
+ <"*W> can be used to get a type out of the directory 
s; and file bsys is presently verifying 
@Enable 
'BSYS<CR> 
(site name)-(system)-bsys version date 
type cntrt-d to adort type ins cntri-p cntrti-c to abort run 
*VCALTDerify Cuser directories) <CR> 


Listing to file <cr> for tty: <CR> 
entire file system? Yes<CR> 
disc verify too? No<CR> 
verify conplete 
*ECALTDxit<CR> 
TRESET<CR> 
>; normal mode is not to verify disc because of the time factor. 


ine) 
wa 


How to do a single user verify 


aEnaple 
'BSYS<CR> 
(site named-Csystem)-bsys version date 
type cntrt-d to abort type ine centrl-p cntrl-c to abort run 
*VCALT>Derify (user directories) <CR> 


Listing to file <cr> for tty: <CR> 
entire file system? Noc<CR>d 
directory: CIRECTORY-NAME<CRD> 
disc verify too? No¢ctR> 
> the directory header information is printed 
sfor the directory of interest 
verify complete 
*ECALT>xIt<CR> 
TRESET<KCRS 
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COMMAND SUMMARY 


APPEND (two archive directories) 

ARCHIVE Cuser files) 

ARCMES (clear tape number from backup words) 
AUDIT DISK USAGE 

BUILD Carchive directories} 

CLEAR C€dackup words in FOS*s) 

CONFISURE (8SYS for another site?) 

CONTINUE OUMP 

COUNT ¢€file pages?) 

DEB8LS BSYS 

DELETE (deleted files) 

DISMOUNT (magtape directory) 

DUMP DIRECTORY 

EXIT 

EXPAND Carchive directory ta include site number and/or dir string) 
FULL DUMP (entire file system) 

HELP 

INCREMENTAL DUMP (changed files) 

INITIALIZE 8SYS Cfrom given file) 

INSERT Cdirectory string after bdb in archive-directory) 
INTERROGATE (the archive?) 

LIST (tape directory?) 

LOAD FILES (from magtape) 

MAP Cuser directory) 

MARK BACKUP WORDS 

MOUNT (magtape directory) 

OCTAL PRINT Cof directory?) 

PRINT THE MAGTAPE ARCHIVE 

PURSE GHOST FILES 

QUIT 

REAPER € Force archive of files in dir over atlocatisn} 
RESTGRE FILES (from tape) 

RETRIEVE Carchived files) 

RUN THE file system Cutility) 

SAVE Carchive directories on tape) 

SINGLE FILE 

TAPE COPY . 

TRIM Cuser directories) 

UNMOUNT Cmagtape directory) 

VERIFY Cuser directories} 
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ERRORS/ACTIONS 


Following is a List of errors that may be encountered using BSYS- 
Corrective action is suoplied if applicablee Normal error format is? 
"Labels ee ce €rror textece" 
Labet: is the BSYS program Label preceding the error and is meant to be 
used as a debugging aid to programmerse 
Cerrors are Listed in alphabetical order without the "Label") 


ATTEMPT TO EXPAND TAPE DIR BEYOND xxx PAGES 
This is a catastrophic failure and means BSYS is really fouled 
(contact responsible programmer )e 

BLOCK SEQUENCE ERROR 
This error may be ignored except when encountered while actually 
restoring a filee It is normally caused by tape unit malfunction 
and you snould retry the restoree If the problem persists you 
should contact the responsible programmere 

CAN*T GET EXCEPTION LIST FILE - TRIM ASCORTED 

CAN®T OPEN EXCEPTION LIST FILE - TRIM ABORTED 
The above two errors are caused by BSYS*%s inability to get the 
List of directories to except from the trim operatione you should 
check the file <ARCHIVED>BSYS-TRIM-EXCEPTIONS-31 

CANT CLOSE ARCHIVE DIRECTORY FILE 
CLOSF jsys failure and can be ignorede If it happens regularly 
have someone check it oute 

CANT CLOSE MAGTAPE 
a random CLOSF jsys failure - no action 

CANT GET USERS ARCHIVE DIRECTORY 

CANT OPEN ARCHIVE DIRECTORY 
Means that 83SYS cant get access to a users archive directorye The 
archive run will be apdorted and the BUILD function must be used 
to make the entries in the archive directory once the problem has 
been rectifiede This error is usually caused by disk space 
(system or user) shortagese 

CENT GET JFN FOR CONTINUE FILE?? 

CANT QGPEN CONTINUE FILE?? ENTERING MANUAL MODE 

NO CONTINUE FILE?? ENTERING MANUAL MODE 

NO CONTINJE RECORD?? ENTERING MANUAL MODE 

FAILED TO CLOSE CONTINUE DUMP FILE?? 
ALl of the above errors signify that something is wrong with the 
continue dump mechanisme Simply supply the data asked for and 
continuee 2@SYS is unable to save the state of the dump white in 
progresSe This is not serious unless the dumo aborts and you wish. 
to restart with the CONTINUE command and even then it is just 
inconveniente This is usually caused by disk space problemse 

CANT WRITE TAPE HEADER - ABORTING 
This is a catastrophic failure and should be Looked at by the 
responsible programmere Most probable cause is a bad tapee 

CLOSF JUSYS FAILURE ?? . 
a random CLOSF jsys failure - no action 

DATA ERROR READING FIRST RECORD OF FILE # 
This error occurs when positioning a tape to the desired file and 
can generally be ignored... 
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QLTRECTORY NUMBER ALREADY USED ON THIS TAPE?? 
This is caused by reused directory number conflicts and should 
only be encountered when "appending" to an old tapee ae other 
occurance is indicative of BSYS program problemse 
ERROR wHILE WRITING TAPE HEADER 
FRROR WRITINGS TAPE DIRECTORY - PAGE # 
Tne above two errors are indications of a bad or marginal tapee 
The tape should be checked for "mountability"™ and in the event of 
failure should be copied (see TAPE copy function) or if possible 
the data should be redumpede 
INVALICO DIRECTORY NUMBER FOR CNODIR 
Indicates an invalid entry in the system index hash table. 
contact responsible programmer or TOPS2Z0 people. 
INVALID FILE DATA (ZERO DIRNUM) 
The file data record (FDBe filenames etcee)? is bade normatily not 
a problem except when rebuilding the directory (see TAPE copy 
functtonde 


ERSTR jsys fe5 uke: in the BSYS error PoOr Ihe. 
NO ROOM FOR NAME IN TAPE INDEXE! 
Ther2 is no more space in the tape indexe This should not happen 
and is symptomatic of a BSYS program probleme 
NON-EXISTENT DIRECTORY NO} 
The DIRST jsys has failed on a valid directory number (¢(TOPS26 
problem?) 
NON-EXISTENT TAPE DIRECTORY NO} 
A previously identified directory cannot be found in the tape 
index plus the equivalent disk directory does not exist - this 
should not normally happen and is symptomatic of SSYS program 
troubles and you should contact the responsible progranmere 
SEQ ERR: 
block nuntbers on tape records are not consecutivee This can be 
caused by tape unit malfunction or BSYS program troublese In 
general can be ignored but if chronic should be investigatede 
TAPE BIRECTORY DISAPPEARED?? 
BSYS attempt to remap a user tape directory failed - 
catastronohic problem and indicates BSYS procram probleme 
TAPE DIRECTORY SPACE EXHAUSTED DUE TO WRITE ERRORS 
Indicates a Bad tape - no recovery ~- you must redump the cata 
on this tapee € note: tin some cases TAPE copy with rebuild option 
will work!) 
THIS TAPE DOZS NOT CONTAIN DATA TO CREATE USERS 
IT®*S NOT THE 1ST TAPE OF A DUMP eceoce 
ihen reloading the disc the first tape of a full dump must be 
used firste After that tapes may be toaded in any order.e 
TRIM FUNCTION TABLE OVERFLOWS: 
EXPAND TABLE "EXLST™" OR DECREASE NUMBER OF 
DIRECTORIES EXCEPTED 
UNDETERMINED TAPE ERROR PLEASE CHECK TAPE AND 
TYPE ANY CHARACTER TO CONTINUE 
UNEXPECTED 10 ERROR INTERRUPTe*es+IGNORED 
The above errors indicate trouble with the tape unit or 
controltlere Continued trouble of this type means more or better 
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maintenance on harcwaree 
UNRECOVERABLE ERROR WRITTING TRAILER 
TAPE IS GO000¢€?) BUTe NOT FOR FUTURE APPENDS 
TAPE MARK=ID AS FULLeee 
Bad or marginal tape - no action 
UNRECOVERASLE TAPE READ ERROR 
BSYS is unable to read the data from a tapeeRetry after mounting 
tape on another tape unit (if available) or cleaning the reed 
headse 
UNRECOVERABLE TAPE READ ERROR ATTEMPTING TO CREATE USERS 
A read error has forced termination of the create users Function 
of restoree Use the DLUSER subsystem to create the user 
directories and type "no" to BSYS when asked to create userse 
UNRECOVERABLE WRITE ERROR WRITING DIRECTORY 
WRITE ERROR IGNORED 
BSYS writes detected error records until no errors occure this 
means recovery is possible (beware!). This usually indicates the 
tape in marginal at bést and redumping is strongly advised. 
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PROGRAMMERS MANUAL 
INTROSUCTION 


BSYS basically runs the file system structure "calling" specific 
function routines for each file encounterede It does this dy mappine 
the system INDEX and copying the user hash tables It then maps each 
user subdirectory into its space and then processes each symool table 
entry oy following the file extension and version chains (see appendix 
PCSYSTEMDDIRECTORY FORMAT"). This allows for multiple functions to be 
performed on a single pass of the file systeme However this facility is 
not presently usede 


The flow of a typical BSYS command is as follows 


A setuo and initialization routine is called by the command 
decoder/recognizere This .setup routine sets the necessary function 
flag(s) for the selected commande The setup routine ts responsible 
for getting all necessary files:(listing devices mag tapes input 
filese temporary fileseee)- It then calls the routine CNTRLe CNTRL 
processes the file <SYSTEMDDIRECTORYs getting the "next" directorys 
and then calling the routine CHECK to process that directorye CHECK 
processes each entry in the directory symbol table running down the 
extension and version FDB chainse The functional processing 
routines (selected by function flags) are called for each file in 
the mapped directory. In order to process a single directory the 
setup routine needs only map the appropriate subdirectory pages and 
cail routine CHECK. 


MAKING A NEW BSYS 
creating a site specific version 


BSYS currently consists of 11 code fitess: 


CBSYS>ASYSCM.LMACL 
CBSYSP>BSYSDF eMAT 
CBSYSPBSYSDR eMAC 
CBSYSD>BSYSDOVeMAC 
CBSYSPBSYSER eMAT 
CBSYSP>BSYSFDeMAC 
CBSYSD>BSYSFNoMAC 
CBSYSP>BSYSFSeMAT 
CBSYSSBSYSFTeMAC 
CBSYSP>BSYSINSHAC 
CBSYSSBSYSTDe MAT 
CBSYSS>BSYSUT MAC 
CBSYSS>GETPRMeMAC 


first Level command 
definitions 
dump/restore/archive 
device handlers 

error handlers 

file system processing 
function execution 

file system subroutines 
cross network code 
initialization 
tapedirectory 

utilities 

cet configuration parameters 


You should obtain the most recent version of the macro code files 
You must then edit the parameters specified in the files in the 
sections of this manual dealina with configuration of BSYS and 
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archive-Lookupe Please follow the convention of giving BSYS files 
at your site the same version numbers as the originals at SRIe 
This allows me to quickly determine the version of the BSYS you 
are runninge Now follow the instructions for assembling a new 
version of SSYSe If (when?) you encounter problems call me!! 


assembling a new version 


A CTL is provided for Loading/assembling a new SSYSe The file 
Js <BSYSDASMBSY-CTLeThis procedure uses CCL and only assembles the 
changed filese The CCL driver file is <BSYSDASNBSY-CMD. 


SUBMIT ASMBSYD>CTL 
ena 
conn bsys 


delete tenex and tops20 versions 


s 


2. we we we 


el bsySe@xXfexsISYSeSaVe* 


exp 


$ 

sload bsys files 

% 

load Gasmbsyecmd 
save tops20 version 
av DOsySe€xe€el 

save tenexe version 
save bsysesav 


start bsys to initialize 


start 
x7z 


ewe DO YY we we ve O we we we Y wt we we 


sdelete initial version (sri has saved configured version) 
$ 
del Bsyseexeel 


exp 


BSYS - TOPS20 Backup SyYySten Page 29 
PROGRAMMERS MANUAL 


CCL criver file <BSYSDASMBSY-CMD ;° 
bsysdfemac 
OSYSCMeTac 
DdSySUremac 
DSySaveNac 
osyseremac 
bsysfdemac 
psysSTtnNeMac 
osysTsSemac 
bsysftemac 
DpsySineMNac 
bsysStdemac 
osysutemac 
getprmentac 


BSYS 
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ARCHIVE SYSTEM 


GENERAL DESCRIPTION 


The archive command is really just a special forn of incremental 


dump with a different criteria for "“incrementatness"™. 


xk 


IMPORTANT NOTE ** 


BSYS dumps a file on two (2) different tapes before it is 
considered archivede When it has been archived an entry is made 
in an archived files directory filee Entries are made in the form 
of a doubly strung List containing BACKUP DESCRIPTOR BLOCKS (BDB) 
plus nameygextension and account stringse This has created the 
illusion for new users of the archive not workinge As two passes 
(one each on different tapes} are required before any files are 
really archivede A standard operational ploy is to run the 
archive twice in a single evening to ensure allt archivable files 
are really archivede This is obviously not necessary but none the 
Less is still done. 


THE ARCHIVE COMMAND 
This command has two basic modes of operation: 


Listing mode 
Allows for generating a List of "archivable" files for a 
specific user(s) or the entire file system. 
It will alternatively concatenate the file <8SYSD>ARCHIVE-TEXT 
and a List of files to be archived for each user and append it 
to his messageetxt filee It provides for mapping fitles-only 
directories to "owner" directoriese 
dumping mode 
Tnis mode is essentially "dump" with the dumping criteria 
peing has the file been written or referenced in the Last "n"® 
dayss where n is the run-time selected archival periode 
The additional function of making entries in the file 
JARCHIVE-OIRECTORYC «31 is accomplished on the marking "pass"e 


MODIFICATIONS TO THE TOPS20 EXECUTIVE 


The following commands have been added to the EXECUTIVE to 


support archiving and retrieving of user filese 


EXEC Command to invoke archiving of a specific file 
@ARCHIVE subfunction filespecs Ee] optional comma invokes 
subdcommands **s are allowed in all fields 


SUBFUNCTIONS > 


DELETE filkespecs Es] mark the file(s) as deleted 
this makes the file invisible to further archive 
status commandse This function can be reversed by 
the UNDELETE subfunctione 
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EXPUNGE alt files that are marked as deleted. This file 
removes the entries from the archive directory and 
can not be undone 


FILE filespecs Es] marks the file(s) for archivinge 


RESET filespecs Ee] reset file(s) archive status bits 
except for the already archived bite 


STATUS filespecs [5] archive status of file(s) 


UNDELETE filesnecs Cel clears the deteted bit in the 
fite(€s) bdb in the archive directory.e 


SUBCOMMANDS:?: ($ means normal defaults) 


G@aDOFERREDC(S$) - archive this file at next regular archival 
run of BSYS 


@@IMMEDIATE - (not implemented yet) 

copy this file to directory <archive> with a funny name and 
when regular archiving done archive it in original 
directories archive with the original name. 


aaDON*T ARCHIVE - do not archive this file 

(BSYS will ignore this file for all archival functions) 
this will include deletion of the funny named file in 
<ARCHIVED if one existse 


aa@DELETE€S) - delete this file after it is archived 

@aDdDON?T DELETE - dont delete this file after it itis archived 
aaRESET - resets all archival attributes of this file. 

this does not "unarchive" a file if it has been previously 


been archivede 


eaSTATUS =—- type the current "archival status" of the 
specified file(s) 


EXEC COMMAND TO INTERROGATE THE ARCHIVE DIRECTORY FILE 
@INTERROGATE CARCHIVE) FILENAME 


eitner types "THAT FILE IS NOT ARCHIVED" " 

or "ARCHIVED ON Csite nickname ITAPES NNN AND MMM"™ 

If the file tis found in the archive directory file 

"DO YOU WANT IT RETRIEVED?" will be askede If the answer 
is yes a message will be Logged on a special Loggere The 
message contains time and dates filenames tape noses 
requesters names ttye and job number. 

When the file has been retrieved the user will be 
notified via the sndmsg facility. 

INTERROGATE has a number of subcommands which atlow 
the user to expand the qualifications of the file 
specification and to get additional informatione Each 
file is specified in the archive-directory by a backup 
directory block (BDB).- The commands ere specified 
in the section on Interrogate suocommandse 
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FLEES USED (BY BSYS 
TAPEDIRECTIORY.TMP 
purpose: 


This file is the tape analog of <system>directoryese It is built. 
and dumplCarchive) time and is written on the tape after 
completion Cas file 0). 


format: 


It is identical in format to <SYSTEMSDIRECTORY with the 
following exceptionse 
The field "FDBADR" ‘which normally contains the disk address of 
the index block for a file contains the “tape address" of the 
first record of the file on tapee This address has the form 
xwd file#eblock#. 
file# = sequential file number (directory is file 0) 
block# = monotonically increasing tape block number 


CSYSTEMDARCHIVE-FILES-ONLY* TXT 


purpose: 


This file is an input file by the archive "deliver messages to 
user" function and is used to map FILES ONLY directories to 
ownerSe For files only directoriesy the List of archivable files 
will be delivered to the owners MAIL.TXT file 


format: 


It is a sequential text file Ceditadle by teco}. It consists of 
Girectory name pairse The user directory name must appear firsts 
followed by by the files only directory name « separated by a 
comma ending in cr Lf Cie? USEReFILES-ONLY-OIR<crif>)d—5 Input 

is terminated by the first null entry (two crlfts in a rowde 


CARCHIVEDSARCHIVE-MESSAGE «TXT 
purposes 
This file contains an arbitrary message to be delivered to users 


who have “"archivable files". It is appended to the users 
messageetxt file along with a list of the files to be archived. 


format: 


Sequential text file (editable by tecod. It is assumed to be an 
asciz stringe message is terminated by the first null ¢€o) bytee 
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CSYSTEMDSSSYS-EXCEPTED-DIRS - see BSYS function exceptionse 
CSYSTEM>BSYSePAQAMETERS - see BSYS configuration parameterse 
CSYSTEMDSSYS-FUNCTION-EXCEPTIONS 

purgose?: 

This file is built by bsys when the file BSYS-EXCEPTED-DIRS is 
changede It is @ binary file that is indexed by directory number 
and gives the flags set to correspond with the function 
specifiede 

<SYSTEMDASSOC.BSYS 
purposes 

This file is used.to allow current directories to access obsolete 
directory files from the archivee It assums that the archive 
Girectory files have been merged and the parameter ASSOC has been 
set in the BSYS-EXCEPTED-DIRS file. 


formats: 


The file is binary with the first two pages reserved to be 
indexed by directory number for a pointer to an asciz string 
of directory names to be associated with this current directory 
as BSYS Looks for the file requested from the archive. 


CSYSTEMORETRIEVE-REQUESTS- TXT 
purposes 
This file is built by <SYSTEMDARCHIVE-LOGKUPeSAV 
wnen the BSYS or exec INTERROGATE command is givene 
It ts used to build the RETRIEVE-REGQUESTSeS5INARY file that 
BSYS checks for retrieve requestse 
CSYSTEMDRETRIEVE-REQUESTSeBINARY 
purposes 
This file gives the reauested fite description including the 
directory to retrive into and the user requesting the fitee 
The two archive tapes for each file are also given in the entrye 
At present there are a maximum of 40 requests processed by S8SYS 
for the retrieve commande. The rest are processed by the next 
retrieve commande 
<*> JARCHIVE-DIRECTORYLeool 
purpose: 
This file ts a directory of all archived files for this 
directory. It is built by BSYS at archive marking time and is 
used by the EXEC command INTERROGATE to "Lookup" archived filesee 


format: 


The file ts binary and consists of two partse 


word Q@ - 
word 1 - LH: 
RH: 
a reserved block ¢ 


free storage area: 


next available free storage 
pointer to current last 8392 
pointer to first BOS 


word address 


6 octal words) 


contains 8DB*s and strings associated with archived file. 


BacKxup 


block 1 
symoolically) 
bdbctl: block 1 


bdbext:s block 1 


bdbadr: block 1 
bLock 
block 
block 
block 


bdbort: 
odbad1: 
bdbad2: 
bdbvers 


bd fed ped fet 


bdbact: block 1 


bdbusw: block I 
3s following is optional for SRI 
bdbsit: block i 


bdblen: 


(file) Directory Block(BDS) definition 


sthe header (not referenced 


sth = control bits (see below)? 
srh = pointer to file name block 
sth = pointer to extension string 
srh = pointer to next bdb 

sth = tape # of ist archive 

srh = tape # of 2nd archive 
sfile protection word 

stime and date of ist archive 
stime and date of 2nd archive 
slh = version number 

srh = pointer to previous bdb 


saccount info for charging 

3+ for location of string 

s- for number 

suser setable word 

cross net retrieve Cexperimental) 

sth = dir string pointer Cif it exists) 
srh = site number where file is archived 
sspecifies site and medium 


BSYS - 
PROGRA 


The 
since 
stilt 
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Bits in LH of BDBCTL Cprimarily for FDB compatibility) 


BDBTMP_406000 sFile is temporary 

BOBPRM_ 209000 sFile ts permanent CTENEX). 

BOBNEX_100000 sNo extension for this bdb yet 

. s(File does not exist yet) 

~BOBDJEL_040000 sFile is deleted (bddb too) 

BOBNXF 020000 sFirst write not complete 
s(File does not exist yet) 

BOBSLNG_610009 sLong file 

BDBSHT_00400C sCompressed page table(TENEX) 

BDBFLG&_062006 sThis is a backup block (308) 


BDOB*s are doubly strunge This is done to facilitate 
reconstruction of archive directoriese 


FIXING SMASHED DIRECTORIES FOR TENEX 


need for piecing directories back together has diminished greatly 
RST found the garoage collection bug a while backe but it is 
necessary to perform this job once in a whilee The following are 


some pointers as to how to accomplish this task for new FENEX KINGS as 
well as some old timerse These methods are certainly TENEX version 
dependents but have remained stable for some timee There are two kinds 
of smashed directories and each requies a different fixe 


Invalid Pointerss Stringse FDB*S etcae 


This type of trouble can range from very minor (easy to fix) to 
major foulups of almost everythinge A system crash white 
EXPUNGING a directory is a rather catastrophic event and may 
dictate following the Absolute Trash solution. 

The BSYS VERIFY function will catch most problems with 
directories and should be used to "diagnose" the troublee The 
output of this function is a List of problems and can be used to 
one-by-one fix theme The OCTAL PRINT function produces a 
formatted dump of the directory and is quite useful in getting eé 
global view of the directory structure as well as the specific 
data in the dtrectorye To actually fix the tad data you can 
either use the BSYS MAP function or the ADBT mapdir method (see 
pelow).s 


Absolute trash 


This situation is caused by a variety of glitches such as bugs¢ 
fat fingerss or flakey hardware but requires major surgery on the 
Girectory involvedse The basic scheme is to "reinitialize" the 
directory so that it appears as though it is emotye This means 
the symbol table is empty and the free storage stuff is all 
reinitialized. 

In general the files in this directory will be tost or backed up 
to the Last dumpe GET into MDDT and 


le map the directory as follows 
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1/ directory numbder 
2/ -1 
call mapdirsx 


2e initialize directory 


1/ 25 smost common block size (FD3 Length) 
2/ 777 sone page directory 

3/ directory number 

call tniblksx 


At this point the directory is Locked so you must set 
DIRORGCDIRECT in BSYS) to -ie Also all the attributes . 
(protections groupss disk Limitseees) of this directory are set 
to the system defaults and must be reset with the CREATE exec 
command or any other suitable meanse You can now reload the users 
files from valid dumps (be sure the disk allocation is set up!)e 


s 


Some interesting data (TENEX) 
symbol table entries must be in ascending alphabetic order 


Account strings have an entry in the symbol table of the form 
XWD string poitntere,100000 


XWO 400100¢s25 - FDB header word 


 XWD 40000le*e# - filename string header word 
(# = string Length + 1) 


XWD 400002s59% - extension string header word 
(# = string Length + 1) 


XWD eg t - account string header word 
(# = string Length + 2) 
The second word 3s a use count 


GENERAL file system PROCESSING 
Running The file system 


In the course of running a TOPS2G system situations arise where you 
would Like to "process" all the files in a given directory or att 
the directories in the system and perform a "one time" modification 
or fixe albeit an infrequent requirement BSYS is an excellent 
vehicle to perform such operationse The command "KUN" is designed to 
process the file systeme Control is passed to the dummy routine 
eDORUN once for each filee eDORUN is a block of 108 POPJ*®s and can 
be used to either patch or assemble in any special functions you may 
desiree The state of the directory run is contained in a set of 
cells in SSYSDF Ccvfscefeadrfdbseee) and can be used to get 
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information about the currente next or last file processed Cie: file 
names extension etce)de 


Mapping directories 


BSYS provides an analogous function to the MOOT call mapdir method 
of mapping user directories and inspecting or modifying theme The 
MAP command has the following advantages: 

specify the directory name (not numbder) 

specify read/write access ¢€a guard against fat fingers) 

ability to use any BSYS subroutines or prewritten user routines 

to perform fixups etCee 
If you GET BSYSeSAV and go into DDTs put a breakpoint at cell BPLOC 
then start BSYS (start$g).- The MAP command will teke the breakpoint 
and you can do as you wish e $P will continue ESYS and all will be 
coole Much thanks to ED TAFT@PARC for contributing this BSYS 
functione 


BSYS Magtape Format 


ALL files consist of "n" records and are separated by EOF markse 
The record size depends on the installation as specified belowe 
The first two words of each record have the following formate 


word 1 tULh= not used 
rh= block number 
word 2 tLh= file number 
rh= page number 


where block number is a monotonically increasing tape block sequence 
numbere file number is the sequence number of this file (directory = 
file 0) and page number is the page number of the file as it would 
appear on diske 


There are four special cases for word 2e 


word 2>= -1 "unused" directory file block. 
word 2= -2 user data record (for CROIR?) 
word 2= file#se-1 end of data record 

word 2= file#see-3 file data record (FDB + strings) 


Directory file: 


The directory file is the only "rewritable”" file on a BSYS format 
tapee This file consists of a header record (length= 64% words} and 
200 512 word "pages". Provision is made for this to be alterable as 
the number of directory pages is contained in the header recorde 
This file is prewritten by BSYS by positive response to the question 
"NEW TAPE?". The rewritabilty of this file is accomplished by 
writting 12 inches of gap (blank tape) at the end of this file at 
initialization time and subsequently only writting 6 inches at 
rewrite timee This scheme has been quite successful at SRI as we 
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have not encountered any problems due to this processe 


Format of header record: 


tohdr: 

tobtiks 0 sheader is block 9 

tponum: 0 s;tape number 

nxtolks 0. ssaved Last block number used (this tape} 
usrblx: 0 sblock # of ist record if user data file 
tpspac: 0 sspace Left on tape 

tofils: 0 scount of # of files on this tape 

site: 0 ssite nickname 

pages: 0 scount # of pages used 

tdpgs: 0 stape directory pages used 

tpsegs 0 sconsecutive dump tape sequence count 
dotks?: “D200 3200 blocks reseved for directories 
tapver: 0 s;format version number of tape 

Lngfln: 0 sstart blockssfile number for long file 
Lngnxt: 0 snext tape number for tong file 

Lnsofst: 0 sfirst tape for long file 

Lngnpg: 0 slong file number of pages 

reserved: block 2 

-tptxt: plock 20 sid entered by operator 


The follow data is site dependent but the Length of the header 
record cannot exceed 64 wordse 
tpid: asciz fArtificat Intelligence Center 
Stanford Research Institute 
333 Ravenswood Drive 
Menlo Parks California 94025 
(41539326~-5200/ 


Tape directory index: 


Subdirectory zero is used as an analog to the TENEX file 
CSYSTEMDSINDBDEX and is used for mapping cirectory name to tape 
directory number and vice versae It has a symbol table ala 
reGular directories with entries of the forms: 


th - pointer to string block containing dir name 
rh - directory number 


This allows for independence of directory numbers on tape and 
diske This solves the problem of deleting a directory and then 
suosequently creating another with the same name but different 
numbere 


***TST has forced all tapes to be written with 39 pages per directory as if 
they were all version 4e This means that TENEX tapes are still tapver 3 but 
the tape directory is mapped with 30 pages/dir instead of 20. 

When a tape is read and the routine TODISC is called the tape 

directory size is determined by the first non-zero directory number on the 
tapee 


kkk 
User Data Files ¢(TENEX optional): 
This file consists of "n" records each containing all of 


the data necessary to create a directory (GTDIR). This file will 
only appear on tape created by a "full" dumpe TOPS20 directories 
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File system Files: 


These files consists of "n+1" records corresponding to the "n" 


pages in the as it appeared on disk plus proceeded by one record 

containing the directory names directory numbere FOdSs and alt the 
strings associated with the fileee There is a one to one mapping 

between the "n" paoaes and the pages on the diske There is no zero 
compression of files ala 1050 save filese 


Trailer Record: 


After the last file on the tape (for non-full tapes)? a special 
record is written - This record is used for positional verification 
when adding files to a tapee This record is simply the first page of 
the "next" file that would be added with a -1 in the page number 
field 

Record Lengths: : 

The Lengths of the tape records are site dependente The standard 
1s 515 (decimal)d.e The HDORLNGeBLKLNGeSDMFLGse and EIOFLG BSYS 
configuration parameters determine the record lLensgthe 
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KNOWN DCFICIENCIES OR GLITCHES 
DEFICIENCIES: 


1} The Trim C€excess file versions) function shoulc use the "default 
file retention" field as its criteria in deleting filese It presentty 
asks the operator for the number to keepe 

2) The LOAC comnand is implemented but withk default to <SYSTEM> if the 
"to" directory is not specified. 

3) The cross network retrieval code is still in development. 

4) The TOPS20 Logical names are not supported by interrogate. 


GLITCHES: 


1) The "deliver to users" option of the archive command was desiaqned 
and implemented before the advent of SNDMSG and its resultant rigid 
MESSAGE TXT file format restrictionse The method used for generation of 
the BSYS archival List makes it difficult if not impossible to supply 
the Length of the message in a SNDMSG type header. A possible solution 
is to get MAILER to deliver the messages (since it supplies a header in 
 SNDMSG format). This would require BSYS to drop out a file of the type 
MAILER Likes and "poke mailer"e This seems Like a rather round about 
way to get things done and a such nothing has been donee Thus the 
"deliver to users function" its rather useless in its present form but 
could be fixed if anyone comes up with a better solution or a need for 
its uSee 

2> The record size of the "user data" record has been changed from 64 
to normally 514 wordse This was done because of a persistent error 
message when working with tapes containing the data to recreate userSe 
This has the effect that the restore entire file system function is 
incompatible with "old" 8SYS tapes. This is thought to be a rather 
unlikely event (to be restoring a non-current file system!)~- but if 
there is a need to do such a thing the cell RWRCRD must pe changed 
from TOWD *D514s3LKNO to IOWD “D64sBLKNO~’ The “0514 ts again site 
dependent 
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BSYS configuration parameters 


Name Type Description 

acsstr asciz string s€cross net only) a string of octal numbers 
swhich specify the acceptable cross site 
snumbers for this sitee Seperated by commas 
sand terminated by an extra commae 


arcnms asciz string sname of archive directory file 
sdefault - (*%v)(rubout) (*viJarchive-directory(*vdL 
ardflg G/1 30/1 - always delete/delete if over allocation 
sdefault - 90 delete after archive 
arcpro asciz string sprotection for archive directory 
sconverted to a numeric value for tenex Ty Seens 
bdbsiz octal vatue ssize of bdb entries in archive dir 


s;default - 12 words per bdb 
soptional - 13 words per bdb for SRI cross net 
sodb which itnctudes sitnum 
blLktng octal value stape data block length 
sdefault - 1003 - normal 
soptional - 1104 to allow ISI to switch tapes 


> between their KA and KL 
chpflg 6/1 31/0 - check for valid user/dontt 
sdefault - @ -don*t check 
soptional - 1 - verify that user name appears 
3 in ¢system>bsys-allowed-usersetst 
crnftg O71 31/0 - cross net code/none 
sdefault - 0 - no cross net code 
soptional - 1 - cross net retrieves for SRI 
r (still experimanial) 
drsflg G/1 31/0 - add dir string to bdb*s/dontft 
sdefault - 0 - don*t append directory string 


sto end of each bdb. 
soptional - 1- Append dir string to end of bdb 
sinserting pointer to dir string in Left half 
sof bdbsit (only after bdbts have been expanded 
dydstr asciz string sfunction Listings to <daily-cump> 
sdefault - all automatic Listings to LPT: 
soptional string of functions whose eutomatic 
slListinas will go to <DAILY-DUMP>tonumeext 
swhere tpnum is tape number input by operator 
and ext is: ARC for archive listing 
FUL for fult dump Listing 
INC for incremental Listings 


we we we 


ejofig 6/1 31/90 - extended/dumpi(€o) instruction 
sdefault - 0 - dumpi/dumpo jsys* 
soptional ~- 1 - extended code to write/read 


tapes for ISI which can be 
switched between their tenex 
and tops20 systemse Used in 
conjunction with hdrting and 
blLklng paramSe 


we We we 


a) we 


fntver 


fundrs 
hdrking 


jozftg 


mftflg 


ndirs 

niknam 
perfig 
oriftg 


savttg 


site 


sitnun 
spool 


ato 


IE RS 


OP S20 


octal 


asciz 
octal 


octal 


0/1 


octal 
asciz 
1/0 
0/1 


O/1 


ectal 


asciz 


octal 
asciz 
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value 


string 
value 


value 


value 
string 


value 


string 


value 
string 
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sfile system directory size 
sootions available 


1 - tenex split directory format 

32 - tenex compact directcry format (%d514 

; words per data record ) 

35 - tenex compact directory format (7d515 

+ words per data record ) 

$4 - tops 20 normal directory size (30 blocks) 
35 - tops 20 expanded dir size (60 blocks) 


sname of function exception file if it exists 

stape header block Lenath 

sdefault - 100 word tape headers 

soptional - 110 word header for ISI to switch 
tapes between their tenex and 
tops 20 systemse 

1/0 - run as job zero 

default - 0 - dontt run BSYS as job zero for 

system verification on start upe 

- allow BSYS to be run as part 

of job zero 

1/0 -—- check for extra word as part of site 

sin tape header . 

sdefault - 6 - don*t check for two word site 

soptional - 1 -— check for two word header and 

sgenerate proper tape header format 

smaximum number of directories on system 

snickname to be specified if not in host table 


optional - 1 


we we OF we oe we Ct we 


31/0 - perpetual bit for archive dir/none 

31/0 - priority jsys avail/none 

sdefault - 0 - no priority jsys*® available 

soptional - 1 - SRI tenex skusr jJsys to enable 

3 BSYS to get higher priority 

31/0 ~- save after config/don*tt save 

sdefault - G - don*t save configured BSYS 

soptional - 1 - save SSYS after initial 

; configuration 

s0/7# - ignore/set data mode 

sdefault - 0 - don*®t set tops 20 tape data 
mode 

optional - 4 - set tape data mode to 


4 ("industry compatable mode") 
for ISI tape switching. 

stape number header string to be printed when 
stape number is requested from operator 

ssite number for cross net retrievals 
scross-net spool directory (defaultibsys-spool) 


ee we 4 
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todfig 0/1 31/0 - special tdir maopinc/none 
sdefauLt - G@ - no special mapping 
soptionalt - 1 - ISI developed code to be 
; intelligent for mapoing directories 
; from tape which no Longer exist in the 
$ file system 
s;following two parameters for tape copy 
tocrld 0/1 30/1 ~- optional rebuild/always rebuild 
tpcemp O71 3071 —- optional compare/never compare 
tpido asciz strina stape id - name and address of site for 
sthe version of BSYS is being run 
unlflg 0/1 31/0 ~- unload tapes/rewind tapes 
s:default - 1 - unload tapes after BSYS is done 
soptional - 0 - rewind only for SRI drives 


which dontt have unload 


The following is the confguration file for tne KL system 
at SRI- The parameters do not have to appear itn any order but any 
parameter specified in the file must appear in the above Liste If 
the default value is desiredy the parameter specification need not 
appeare The file LCaici<system>bsyseparameters contains: 


ARCNMS?SASCIZ /JARCHIVE-DIRECTORYC/ 
ACSSTRIASCIZ f2ee/ 

CHPFLG21 

EYTOQFLG2O 

CRNFLG=1 


FMTVER 35 

NOIRS21409 

HDRLNGS100 

BLKLNG?1003 

BDOBS1Z2213 

SiTNUM? 2 

XCPFLGOii1 

DYDSTR:EASCIZ ARCHIVE s°>ULLe INCREMENTAL/ 
SITEGZSASCIZ / AIC tape / 

TPIDPZASCIZ /Artificial Intelligence Center 
Stanford Research Institute 

333 Ravenswood Drive 

Menlo Parke California 34925 
(415)326-6200/ 
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ARCHIVE-LOOKUP configuration parameters 


Name Type Description 
arcenms asciz string sname of archive directory file 
sdefault - (¢(*v}€ruboutd(* vi Jarchive-cdirectory(*v)L 

earcoro octal vatue sprotection for archive directory 

Lokdro asciz string sname of directory where archive-lLookup 
sresidee Used in connection with savfilg fer 
ssaving configured version of BSYS-e 
sdefault - SUBSYS 

ndirs octal value smaximum number of directories on system 

niknam asciz string snickname to be specified if not in host table 

savfig 0/1 31/0 ~ save after config/don*t save 

sdefault - 0 - don*t save configured B8SYS 

soptional - 1 -— save BSYS after initial 


configuration 
ssite number for cross net retrievals 
s(still experimaental) 


we 


sjitnum octal value 


The following is the confguration file for the KL system 
at SRI. The parameters do not have to appear in any order but any 
parameter specified in the file must appear in the above Liste If 
the default value is desireds the parameter specification need not 
appeare The file CLaicl<tsystem>lookupeparameters contains: 


ARCNMS2ASCIZ /IJARCHIVE-DIRECTORYC/ 
SAVFLGi1 

NDIRS*S1400 

SITNUMi2 
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BSYS Function excpetions 


gESYyS use a file to determine which functions are to be excepted 
for which directoriese For example » if there are certain directories 
which are to be excepted from archivina and or incremental dumpsy 
their names would be included in <system>osys-exceoted-dirse BSYS 
uses this asciz string file to create a bit table file 
CSYSTEM>bsys-function-exceptions which it uses for checking to see 
if the presently specified function is to be performed any or all 
directoriese A new version of bsys-function-exceptions is created 
anytime BSYS is started up and BSYS determines that bdbsys-excepted-dirs 
file has been changede 


The format of <system>bsys-excepted-dirs is a directory 
name string terminated by a colon and followed by the name(s) of the 
functions to be excepted for the specified directorye The 
exception file for SRI KL system appaers below as an example. 
The example shows that the directory SPOOL is to be excepted 
from archive and incremental dump functions and ROOT-DIRECTORY 
is to only pe excepted from archivee 
The following functions are acceptable after the 
directory specification: 


ARCHIVE - Don*t auto archive from this directory, but 
accept specific archive requestse . 

ASSOC - This directory has access to directories specified 

in the <SYSTEMDASSOC.eBSYS filee 

AUDIT - Con*t show disk usage for this directorye 

COUNT - Don*t show disk usage for this directcry. 
(Tenex side affect - replace the count presently 
in the directory by that just calculated for the 
dtirectorye) 

DUMP - Dontt dump files from this directory (DUMP BSYS 
functionde 

FULL - Dont*t dump files from this directory as part of a 
full system dump (normally all directories). 


INCREMENTAL - Don*t dump change files from this directorye 
MSG - Bon*t send message after the retrieve request to this director 
PURGE - Don*t purge ghost files from this directory 
(files that dontt exist yetde 
SAVE - Dontt save the archive directory from this 
. directorye 
TRIM - Don*t trim intermediate versions of files in 
this directory. 
UPRVER - Don*t auto archive the highest version of any files 


unless specifically requestede 
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Example of Caicld<system>bsys-excepted-dirs 


BSYS-SPOGLIARCHIVEs INCREMENTAL 
RVOT-DIRECTORY ARCHIVE 
GEOFF SARCHIVE 
GEOFF27ARCHIVE 
L1O01B8-MONTITORZARCHIVE 
1GiB-SOURCESS ARCHIVE 
101B-SUBSYS: ARCHIVE 
1GIB-EXECCARCHIVE 
DOCUMENTATION: ARCHIVE 
SOURCES * ARCHIVE 
SYSTEMSARCHIVE 
SUBSYSSARCHIVE 
NEWSYSSARCHIVE 
SUPPORT? ARCHIVE 
FRONT-END2 ARCHIVE 
BINARYS ARCHIVE 

MFEXECS ARCHIVE ‘ 
DEV-RSEXECCARCHIVE 

TVS ARCHIVE 

MOARCHIVE 

ClSARCHIVE 

FES ARCHIVE 


BSVS 7 


PROGRAMME 


CPS$20 
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Interrogate subcommands 


gaA_LeFILES - displays deleted and undeleted bdb 
infornatione . 

qaBEFOREs*DATE - only display files archived before 
specified datee 

2aDATES - print out dates when file was archived. 

@ADELETEDeFILESe ONLY ~- only display deleted files (ddb) 

QaDOUBLEe¢SPACE - Listina format control. 

eae ERYTHING - all data for files. 
@INDIVIBUAL - select option to disptay file 
information and wait for user command before 
continuinge This option interacts with the user 
allowing simplfied retrieval of multiple filese 
The user commands are? 


B 
D 


~~ 


backup to previous file data 

mark this bdb as deletede The bdd goes away 
only when an "ARCHIVE EXPUNGE"™ EXEC command 
is typed.e. 

go back to exeCe 

retrieve this filee The "Do you want this 
file retrieved" question is not asked and 
consequently this is an easier way to 
retrieve a large number of files. 

undelete the presently displayed file (808). 
If the ALL.FILES or DELETEDeFILES-ONLY options 
ere selected then deleted bdbts will be 
displayed and can consequently be undeteted. 
uD arrow is same as "B" backup commande 


e 


<lf> - display next file. 
<cer> - display next file. 


Q) 


Ce ee 


2 
76) 


22) 8&2 9) 2) @ ©) wo 
a5 


) 


ILPT = 
NOseHEADING - dontt print headinge 

NUMBERS - absotute index of bdb in archive-directorye 
BOUTPUT. .. eee - Listing to specified file. 

SPROTECTION - print protection of filee 

IREVERSE. ee ~ display okdest pdb data first.e 
SINCE-DATE - display data for files since cate spece 
JaSTATUS - delete/undelete status of bdb. 

adTAPE - tape number associated with file spece 


Listing to LPT: 


ASTIMESeAND.DATES - when file was archivede 


2) 


aaVERBOSE - full print of command datae 


QSCARRIAGE RETURN TO GO - start display of filese 
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The following commands are undocumented at the present 
timee but will pe added in the near futuree 
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INDEX 
ARCHIVE SYSTEM e « © © © © © © e 


archiving user filest ec « «© « e« 


BSYS Magtape Format a a 


COMMAND SUMMARY © 2 © © © © © 
Configuring BSYS e« e e «© © © © e 
Configuring archive-lookup e e« e 
Continuing DumpS e e e © «© © © e 
CONVENTIONS e e e e e606 ° os e @ 
COUNT (directory file pages) e . 


DISMOUNT (magtape directory). e 
Dumping a User Directory(s) ° 
Dumping the entire file system 
DUMPS e e e oe e e e ¢ ® e s e 


ee @ @ @ 


ERRORS/ACTIONS « © «© © © © © ec 


file system UTILITIES ¢« e 
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BNS. CHANGES 
Fon~ ESL 4-So -§ | 


added “bypass restore checks “ question to initial RESTURE 
code. Cleanup RETRIEVE subcommang code. Add EXIT to RETRIEVE 
subcommand to return to BSYS primary command level. Added auto 
headina code for archive,full and BRS aah dumpse Added 
auto heading to SAVE functione Clean up KETRIEVE code. 
Make tape copy. be smart about EUT on write. 
Expanded list to be able to select one cirectory Be the 
tape to list. 
Made tape copy code finally work. 
Added append archive directories conmand and code. 
Added insert directory string atter bdb in arcnive directory 
(requires expanded archiverdirectory). 
Fixed octal dump so that it uses directory numoer from tape 
for Gumpina directories from tape (required chenges to 
oSysut “ user code). 
Agded initialize command to check out bsvseparamters files 
before they are installed on the systeme 

Added new cross net site number and perf lq for new perfla 


-Enttialization parameter. 


Ada perpetual file bit chfdb tnstruction. Provice more 
information for GETARC failure. Added cade to tapdsk 


to clear archive pending, dump not complete and dumper bits from 


pockup flag bits. 

Made reading fo the fdb data at the becining of the file 

imto @ seperate routine to enable tne reacing pages at the 
end of a jlonq file ( page number 777777 specifically) 

Added code to tapei so that 1) bSYS will accept any bSYS tape 


format (ie. 100,110 octal header length, Sliesdleesece Gata record 
length). 2) In conjunction with a switen in todisc, allow differnt 


Start numbers for record number sequencing (olkno). 

Put in auto continue for tape sequence number difference 

of only 1. ‘ 

Agded chkptn tape cove to pce t to read the tape before 
writing dummy cirectory. If the tape is an archive tapes 
then bsys halts. Ifgit it is a dump taper then osys will 
ask if the user wishes to continue. Addition to an 

existing tape is not affected. 

Corrected longstandina oroblens connected with eot 
DrOoceSsSiInge 

Added code to ptfile to make searching dawn tapes 

fester by elininatina reading of the fab data from tne 
front of each file until the tep-e is close to the 

tile number of interest. 

Corrected &@ bua tn entre) which orevented specific arcnives 
from directories which hada auto archives excepted 

Aaded code for. append archive directories 

Laded code to insert dir string in archive directory bdb's 
Modified expand and beb pullaing code to support append and 
insert functions. 

Adced isi code to prevent overwrite of perpetual files on 
restore. 

kxpanded bldrst to allow (via orsttu) appendine of a cir 
string to the ena of bdb's., (future plans call for the 
eading of a symbol teble to the archive aGirectory to Keep 
track of dir strinas 4ssoctated witn various bdo's) 

euded code to allow (vid the exceptions file code ) to 

auto archive 61] but the niqhest version of a file which 
has not been read in "nm gays", 
Fixed buqs in the full restore code. 
Adeea code for perpetual pit capabilty 


rearranged code so that the init command would work 
properly — 
Fixed buds in the getcemd code. 

usystd * Fix pug in allflse add code to todise to correspond to tapei 

| code for determining tape record lengths. Added check in scan 
to Keep it from runnina away if nunoer of pages im tape 
header does not match actuél reéa ine Added cade to inittd so 
that copy will] copy the data as itt is on tape and not do dirst's 
from the file system. 
Aaded code to inittd so that on tape copy, BSYS will get the 
string from peget100 instead of 4 cirst. 
corrected lona file page count problen in dinpecte 
Correctedq ancient bugs in the code used to expand the 
index of directories on the tape. 
Aadead S$scan ang expanded scan to allow scanning of 
single tepe directory. 
Changed tdirst so thet it will not getault to the file 
system dir nute 

osySut ™ Added tuser to get user number from tape instead of file 
SYSTEM. 


& AUG 1974 41435"8PDT 
NAGEL 
Seo ;2@ets tS 2502 


LO*eMAY™@76 212432 46"PD0T, 10975, 000000000001 


A Nba VERSION OF GSYS HAS BEEN- INSTALLED. THe NEW BSYS UFFERS 

beste Wow FEATURES THAT WILL ALLOW THe USER TU MANTPULATEe THEIR 

wiotl Ur AKCHIVeu FILES. THE THREE FEATURES ARt INTERRUGATE, DELETE, 

aw UNDELETE. INSTALLATION g3F THE NEW BSYS HAS CAUSED SUME GF THE 
SCHIVE LIST TO READ "YTAPE OY. THIS SHOULD SE IGMHURED SY THE USER. 


ThE NEW FEATURES ARE OESCRIBEG BELOW. 


TENEA@ESYS 3.02 6*AUG"74 
SINTERRUGATE (THE ARCHIVE) (CR) 


Ve. Gy sALTMUUE COMMA wILL GtT YOU INTO SUBCUMMAND 


Ri ePELLES 
SELETEU.FILES.ONLY 
JRORLE TEU. ELLE S.UNLY 
VER bUSE 
EVcRYTHING 
ede 
TIMES.SAND. DATES 
Pi PECTION 
StLFURE.UATE 
STNG es UATE 
ee 
HEAULNG 
ae VERSE « URDER 
JGEPUT s TuekILle 


ed a 
CARKIAGE RETUKN TO GO 


wg 


BSYS DELETE AND UNDELETE FUNCTLUN 


“DELETE (ARCHIVE ENTRY) (CR) 
FILENAME EXTSVER = (CONFIRM] (CR) 
SUNUELETE (ARCHIVE ENTRY) (CR) 
rFLLENAME.EXTSVER = [CONFIRM] (CR) 
SEXIT (CK) 


aa 


ti=Aor=75 16:210:55@PST,1706; 000000000001 

pete Ti Aor 2976 TerOerst 

rroom? &MUOGRE 

Sup ject: bBSYS changes 

hodid restore on tops20 should work nowe The directory files from the 
root*directory are dumped at the begining cf each inc or full dump. The 

taeode Gcirectory is not told that the files are there because there is not 
enough room in the tape directory. aA temporary file called RUTDIRECTORY.TMP 
is generated from these files and used to create users and for restore checks. 


S dist of directories ts checked to prevent the Jarchivesdirectoryl file from 


weing generated at the time pf the archive. (printersxgqpy..etce) 


Ine octal print command allows the INDEX file to be specified and gives the 
format of the subindices that are selected for tenex. 


Ine puiled commanc generates the archivemcirectcry entries trom tne second 
tadoe of tne archive only. 


Non=privileaed users may dump their own directories with BSYS. 
Tne perpetual and ephemeral bits are restored from tenex tanes to tenex sites. 


Tne load command can store files or groups of files from a tape 
cirectory to the same or other system directory as new files. 


The wild cards “, should work now. 


Archives, Gumbo, restore and retrieve af multi@=tape files shoulda work now. 


Tne map function with write access should work now for tops20. 
The oage mapping for a tile can be specified with the list command. 
ite nark command will now connect to the directorv thet is specified. 


Tre delete subcommaend to retrieve should work now. 


ne code for UPRVER* don't auto archive the nighest version of any files 
unless specifically requested™ has been fixed. 


Tn2 automatic listing has been taken out for archive. 


17*AUG™76 1L1L2:022:41™"=PDT, 323; C00000000000 
Late: i7 AUG 1976 1102¢"PDT 

From: WMUGKE 

Subject? B8SYS.SAV; 50458 


bon't erchive the JARCHIVE*DIRECTORYL file. 
acd ASSUC parameter to access old directories. 


bon'tt clear tape with ARCMES ff the archive date is older than ¢4% hours. 


« 


JTaxe the extra eof out of the tape copy after writing the directory. 


sa ita eoeee a 
24*AUG@75 17216257"=PDT, 120; 000000000000 
wate? 24 AUG 197% 1716*PDT 

From: WMOORE. 

Sudjecti BSYS.SAV; 50459 


Jnme REAPER command has been implemented. 
26*AUG™76 172062 26"PDT, 214; 000000090000 
tiate: 26 AUG 1978 1706*PDT 

From: WMUOQRE 

Sup ject: BSYS;50460 


Permanent tiles are dumped even if deleted ang have zero pagese 


The dump listings print the directory name even if no files are dumped. 
S0°AUG™75 13:236:558PDT, 276; 60G0000000500 

bate: 30 AUG 1976 1336=PDT 

Prom: WMOGRE 

Subject: BSYS;5U46]1 


Tne subcommand for retrieve will now List large tape numbers. 


Itie check for existing tile for retrieve has been changed. 


the incremental dGgump will list only directories that have files dumpede 


L5"DEC#7E 10:33°49=PST,257; CO0O0CQ000000 
Uete? 15 DEC 1978 1033=PST 

Prom? WMUDRE i 

Subjects BSYS;50464 


Imolement converston of time and cate between tenex and tops20 when 
restoring, loading, retrieving, and single file transfer of files 
writen on one system and read into the otner. 
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